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Enterprise Cluster Master 
Toolkit Version B.01.05 Release 
Notes 


Announcements 

The Enterprise Cluster Master Toolkit is a set of templates and scripts 
that allow you to configure ServiceGuard packages for the H P Domain 
I nternet servers as well as for several third-party database management 
systems. This unified set of high availability tools is being released 
together for H P-UX 10.20 and H P-UX 11.0 in version B.01.05 with the 
following product numbers: 

• B5139CA license and media for H P-UX 10.20 

• B5139DA license and media for H P-UX 11.0 

The master toolkit is a collection of specific product toolkits, which 
i ncl ude the fol I owi ng: 

• HA Foundation Monitor toolkit, designed to monitor the status of an 
entire mission critical environment. 

• H A i nternet tool kits for use with HP Domai n server products. 

• Database tool kits for Oracle, I nformix, Sybase, and Progress 
database management systems. 
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What's in this Version 

This release contains defect repairs only. Refer to "Patches and Fixes in 
this Version"for details. 

Effective with this release, the following product toolkits are available: 

• HA Foundation Monitor Toolkit. This toolkit is designed to monitor 
the status of the mission critical environment. It assists the H P 
support engineer with tracking cluster availability in the areas of 
cluster nodes, network components, and packages. A cluster 
availability report will be generated nightly if an event occurs in any 
of these areas. 

A white paper describing this toolkit, "I nstalling and Configuring the 
Foundation Monitor Toolkit," is available on the documentation web 
site: 

http://docs.hp.com/hpux/ha 

• HA I nternet Toolkits. These tool kits enable you to run all your 
Domain server software as ServiceGuard packages. Each toolkit 
contains example scripts and package configuration files, together 
with a RE ADM E file that explains how to customize the package for 
your needs. Toolkits are provided for the following Domain 
components: 

— FastTrack Server 

— Enterprise Server 

— Enterprise Server Pro 

— Proxy Server 

— Directory Server 

— Messaging Server 

— Col I abra Server 

— Calendar Server 

Refer to the HP Domain Release Notes on HP-UX 10.20 (J 1582-90112) 
or the HP Domain ReleaseNotes on HP-UX 11.0 (J 1582-90128) for a 
discussion of recent changes to these products, as well as a 
description of problems and workarounds. 
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• DatabaseToolkits. These are provided to simplify the setup of 
ServiceGuard packages for your database software. Each toolkit 
contains example scripts and package configuration files, together 
with a RE ADM E file that explains how to customize the package for 
your needs. Toolkits are included for the following database products: 

— Informix 

— Oracle 

— Oracle 8i’s Oracle Standby Database 

— Progress 

— Sybase. 

Minor corrections and enhancements are included with this release. 
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Table 1-1 


Table 1-2 


Compatibility Information and Installation 
Requirements 

Compati bility 

The EnterpriseCluster Master Toolkit requires the installation of the 
HP-UX operating system together with either MC/ServiceGuard 
(B3935CA or B3935DA) or ServiceGuard OPS Edition (B5161DA or 
B5161EA), formerly known as MC/LockManager. 

Compatible versions of ServiceGuard and ServiceGuard OPS Edition are 
shown in the following tablefor the Foundation Monitor: 

Foundation Monitor Compatibility with ServiceGuard and 
HP-UX 


Foundation 

Monitor 

Toolkit 

Version 

HP-UX Version 

ServiceGuard 

Version 

ServiceGuard 

OPS Edition 
Version 

B.01.47 

HP-UX 10.20 

A.10.10 or 
greater 

A.10.07.01 or 
greater 

B.01.47 

HP-UX 11.0 

A. 11.01 or 
greater 

A. 11.01 or greater 


Compatible versions of MC/ServiceGuard and ServiceGuard OPS Edition 
are shown in the following tablefor the database and internet toolkits: 

Database and I nternet Toolkit Compatibility with 
MC/ServiceGuard and ServiceGuard OPS Edition 


Master Toolkit 
Version 

HP-UX 

Version 

ServiceGuard 

Version 

ServiceGuard 

OPS Edition 
Version 

B.01.05 

HP-UX 10.20 

A. 10.10 or 
greater 

A.10.07.01 or 
greater 
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Table 1-2 


Table 1-3 


Database and Internet Toolkit Compatibility with 
MC/ServiceGuard and ServiceGuard OPS Edition 


Master Toolkit 
Version 

HP-UX 

Version 

ServiceGuard 

Version 

ServiceGuard 

OPS Edition 
Version 

B.01.05 

HP-UX 11.0 

A. 11.01 or 
greater 

A. 11.01 or greater 


Compatible versions of specific database and I nternet server software 
products are shown in the following table: 

Script Compatibility with Internet Servers and Databases 


Internet Server or 
Database Name 

Internet Server or 

Database Version (as 
shown in swlist output) 

Toolkit Version 
(“what” string) 

FastTrack Server 

B.03.01.05 

B.01.02 

Enterprise Server 

B.03.06.00 

B.01.02 

Enterprise Server Pro 

B.03.05.04 

B.01.02 

Proxy Server 

B.03.05.04 

B.01.02 

Directory Server 

B.03.01.03 

B.01.02 

Messaging Server 

B.03.05.04 

B.01.02 

Collabra Server 

B.03.05.01 

B.01.02 

Calendar Server 

B.03.05.02 

B.01.02 

Informix 

All 

B.01.04 

Oracle 

7.3.x, 8.0.x, 8.1.x 

B.01.04 

Oracle Standby Database 

8.1.x 

B.01.04 

Sybase 

10.0.2 

B.01.04 

Progress 

7.3.A 

B.01.04 
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Table 1-4 


Table 1-5 


Installation 

Use the H P-UX swinstaii command to install the Enterprise Cluster 
Master Toolkit on the cluster node where you plan to perform package 
configuration tasks. The locations of the specific toolkits are given in the 
next sections. 

Location of Foundation Monitor Toolkit 

The foundation monitor toolkit isfound in the following directory: 

Directory Pathnames of Toolkits 


Toolkit 

Directory Pathname 

HA Foundation Monitor 

/opt/cmcluster/toolkit/foundation 


Follow the instructions in the readme.pdf file that accompanies the 
toolkit. 

Locations of Internet Toolkits 

The I nternet toolkits are found in the following directories: 

Directory Pathnames of I nternet Toolkits 


Internet Toolkit 

Directory Pathname 

FastTrack Server 

/opt/cmcluster/toolkit/fasttrack 

Enterprise Server 

/opt/cmcluster/toolkit/domain 

Enterprise Server Pro 

/opt/cmcluster/toolkit/domain 

Proxy Server 

/opt/cmcluster/toolkit/domain 

Directory Server 

/opt/cmcluster/toolkit/domain 

Messaging Server 

/opt/cmcluster/toolkit/domain 

Collabra Server 

/opt/cmcluster/toolkit/domain 

Calendar Server 

/opt/cmcluster/toolkit/domain 


Follow the instructions in the READM E filethat accompanies thetoolkit 
you wish to configure as a package. 
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Locations of Database Tool kits 

The database tool kits are found in the following directories: 

Directory Pathnames of Database Toolkits 


Database Toolkit 

Directory Pathname 

Informix 

/opt/cmcluster/toolkit/informix 

Oracle 

/opt/cmcluster/toolkit/oracle 

Oracle Standby 

/opt/cmcluster/toolkit/SGOSB 

Sybase 

/opt/cmcluster/toolkit/Sybase 

Progress 

/opt/cmcluster/toolkit/progress 


Follow the instructions in the READM E filethat accompanies thetoolkit 
you wish to configure as a package. 


What Manuals are Available for this Version 

For information about configuring packages using the tool kits, refer to 
the foil owing manuals. I n addition, be sure to review the README file 
that accompanies thetoolkit you are using. 

• Managing MC/ ServiceGuard (B3936-90026) 

• Configuring OPS Clusters with ServiceGuard OPS Edition 
(B 5158-90026) 

I f you are a Domai n user, you should refer to the FI P Domai n Release 
Notes on HP-UX 10.20 (J 1582-90112) or the H P Domain Release Notes on 
HP-UX 11.0 (J 1582-90128) for a discussion of recent changes tothese 
products as well as a discussion of problems and workarounds. 

For the Foundation Monitor toolkit, a white paper entitled "I nstalling 
and Configuring the Foundation Monitor Toolkit" now appears on the 
HP documentation web page: 

http://docs.hp.com/hpux/ha 
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Patches and Fixes in this Version 

J AGad06432: Database Script Monitors Wrong 

Processes 

• Problem: Oracle, Sybase, Informix, and Progress database tool kits 
werefound to be monitoring the wrong processes if the user employed 
overlapping instance names (that is, if one instance name was a 
substring of another instance name). 

• Resolution: The scripts have been modified to correctly recognize 
overlapping instance names as belonging to different processes. 
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Known Problems and Workarounds 

The following describes known problems with the Enterprise Cluster 
Master Toolkit and workarounds for them. 

I f you are a Domai n user, you should refer to the H P Domai n Release 
Notes on HP-UX 10.20 (J 1582-90112) or the H P Domain Release Notes on 
HP-UX 11.0 (J 1582-90128) for a discussion of additional problems and 
workarounds. 

Naming of Netscape Server Instances 

• What is the problem? If you configure multiple instances of the same 
Netscape server type, and the Serverl D of one server is a substring of 
the Serverl D of another server, ServiceGuard may fail the wrong 
package unexpectedly. 

• What is the workaround? Choose distinct, non-overlapping instance 
names as in the foil owing example: 

ServerlDl: httpd-defaultl 

ServerID2: httpd-default2 


Do not use httpd-default for ServerlDl and httpd-def aultl for 
ServerID2. 


Changed Directory Location and Port Setting for 
Enterprise Server (Version 3.6) 

• What is the problem? I n Netscape Enterprise Server (version 3.6), the 
installation directory and port setting have been modified. 

• What is the workaround? I n the runhalt script enterprisesh (version 
B.01.02) Iine51, modify the environment variable SE RVER as 
follows, to reflect the new installation directory: 

SERVER=/opt/ns-enterprise3 6/https-${SERVER_ID} 


When accessing the administration server for Enterprise Server 
version 3.6, use port 17493. For example in your browser, use the 
following URL: 
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http://192.1.1.3:17493 

where 192.1.1.3 is the IP address of the system on which you are 
running the administration server. 

Failure of the uxwdog Monitoring Process 

• What is the problem? In Enterprise Server version 3.6, a Unix 
daemon, uxwdog, now monitors the health of the web server daemon, 
known as https-< InstanceName>, where InstanceName is the name 
you give to a specific server instance. (The default daemon name is 

https-default.) 

I f the web server process termi nates, the uxwdog daemon wi 11 
automatical ly restart the web server daemon. The problem is that 
when the uxwdog daemon terminates with the web server still 
running, the administration server cannot be used tost op or start the 
Webserver. (This problem can be caused by using the command kill -9 
<PI D>, where <PI D> is the process id of the uxwdog daemon.) 

F urthermore, the tool kit that is monitoring the uxwdog daemon will 
cause the package to fail over to the adoptive node, and it will fail to 
run on the adoptive node. 

• What is the workaround? If the uxwdog daemon fails, the web server 
process should be manually killed as in the following: 

kill -9 <PID> 

where <pid> is the process id of the web server process. This will 
allow the web server to be started through the control of the 
administration server. 
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Software Availability in Native Languages 

The Enterprise Cluster Master Toolkit is not available in native 
language versions. 
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